Массовое удаление автомобилей

Запрос позволяет логически удалить (архивировать) несколько автомобилей по их идентификаторам.

Синтаксис запроса

POST https://b2b-api.go.yandex.ru/integration/2.0/vehicles/bulk-archive

Заголовки запроса

• Authorization: Bearer <OAuth-токен>
  Процесс получения токена описан в разделе Начало работы.

• X-YaTaxi-Selected-Corp-Client-Id — ID клиента из Личного кабинета. Обязателен, если по токену доступно несколько клиентов.

• X-Idempotency-Token — токен идемпотентности, строка формата UUID. Одному токену идемпотентности соответствует один заказ, для нового заказа нужно сгенерировать новый токен. Обязательный заголовок.

Тело запроса

Данные передаются в формате JSON:

Описание полей ответа

Успешный ответ не содержит тела (возвращается статус 200 OK).

Пример запроса

POST https://b2b-api.go.yandex.ru/integration/2.0/vehicles/bulk-archive
Authorization: Bearer <OAuth-токен>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>
X-Idempotency-Token: <токен>

  {
    "vehicle_ids": [
      "vehicle-abc-123",
      "vehicle-def-456"
    ]
  }

Пример ответа

{ }

Возможные коды ответа

• 200 — машины успешно удалены
• 400 — ошибка валидации параметров
• 404 — одна или несколько машин не найдены
• 503 — ошибка сервера